home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / Mosaic-2.6b3 / README < prev   
Encoding:
Text File  |  1995-07-11  |  4.0 KB  |  116 lines
  1. NCSA Mosaic for the X Window System Version 2.5
  2. ===============================================
  3.  
  4. Welcome to NCSA Mosaic for the X Window System 2.5!
  5.  
  6. This README details installation steps.
  7.  
  8. More complete information and documentation on NCSA Mosaic is
  9. available online, via NCSA Mosaic.
  10.  
  11.  
  12. Binaries
  13. --------
  14.  
  15. NCSA Mosaic is known to compile on the following platforms:
  16.  
  17.   SGI (IRIX 4.0.x and 5.x) 
  18.   IBM (AIX 3.2.4)
  19.   Sun (SunOS 4.1.3 and 5.3 (Solaris))
  20.   DECstation 5000-200 (Ultrix 4.x)
  21.   DEC Alpha (OSF/1 1.3 and 3.0)
  22.   Hewlett Packard (HP/UX 7.x, 8.x, 9.x)
  23.   Pentium (Linux 1.1.94)
  24.  
  25. Binaries for these platforms (and possibly others) are available on
  26. ftp.ncsa.uiuc.edu in /Mosaic/Unix/binaries/
  27.  
  28. If you have to make nontrivial changes to NCSA Mosaic to get it to
  29. compile on a particular platform, please send a set of context diffs
  30. (e.g., 'diff -c oldfile newfile') to mosaic-x@ncsa.uiuc.edu.
  31.  
  32.  
  33. Installation Instructions
  34. -------------------------
  35.  
  36. Simply examine the toplevel Makefile, change the appropriate
  37. customizable options, and type 'make'.  
  38.  
  39. The final result is a single independent executable, src/Mosaic.
  40.  
  41. (The Makefile.[sun,dec,ibm,alpha,etc.] files are the Makefiles we use
  42. locally for compilation on various platforms; they will almost
  43. certainly NOT WORK for you without modification.  We recommend you
  44. start with the stock Makefile and make modifications as necessary to
  45. avoid confusion.)
  46.  
  47. There is one tricky thing:
  48.  
  49. -- You have the option of compiling in support for NCSA HDF, a
  50.    platform-independent hierarchical scientific data format, and NCSA
  51.    DTM, a network-based message-passing protocol useful for exchanging
  52.    scientific data between applications.  If you compile one of them
  53.    in, you should compile both of them in.  
  54.  
  55.    If you don't already know what HDF and DTM are and want to compile
  56.    Mosaic quickly, forget about them for the time being -- you can
  57.    always recompile later.
  58.  
  59.    The DTM library is in subdirectory libdtm.  The HDF library must be
  60.    obtained separately from ftp.ncsa.uiuc.edu in /HDF; get version
  61.    3.3r1 or later.  Set the various options in the Makefile to point
  62.    to all the right places, and you should be set.
  63.  
  64.  
  65. After You Have Compiled
  66. -----------------------
  67.  
  68. If you do not normally run Motif on your system (e.g., if you run Sun
  69. OpenWindows instead), then you may get a whole bunch of run-time
  70. errors about translations when you start Mosaic.
  71.  
  72. If this happens, copy the file XKeysymDB (included in this directory)
  73. to /usr/lib/X11.  (If you compile Mosaic yourself, you may need to
  74. place this file elsewhere, depending on your X configuration.)  See
  75. the FAQ list online for more information.
  76.  
  77.  
  78. X Defaults
  79. ----------
  80.  
  81. NCSA Mosaic includes sets of fallback X resources that provide
  82. reasonable screen display properties for three configurations: color,
  83. monochrome, and color SGI.  (Color SGI has its own configuration since
  84. SGI systems commonly use a gamma correction factor of 1.7, which makes
  85. their screens brighter than usual.)
  86.  
  87. If you compile NCSA Mosaic out of the box, or if you download a binary
  88. from ftp.ncsa.uiuc.edu, the default resources will be for a color
  89. display (or, if you compile on an SGI, the default will be for color
  90. SGI).  See the Makefile for information on how to have monochrome
  91. resources by default.  On the command line, the flags '-mono' and
  92. '-color' allow you to switch resource configurations at runtime.
  93.  
  94. For your convenience, three corresponding X app-defaults files are
  95. included in this distribution: app-defaults.color,
  96. app-defaults.color-sgi, and app-defaults.mono.
  97.  
  98.  
  99. Bug Reports and Comments
  100. ------------------------
  101.  
  102. Bug reports and other comments can be sent to mosaic-x@ncsa.uiuc.edu.
  103.  
  104. If you find NCSA Mosaic useful or particularly interesting, please
  105. also send us a note -- continued development of this project partially
  106. depends on user feedback and support.
  107.  
  108.  
  109. --
  110. Dave Thompson   <davet@ncsa.uiuc.edu>
  111. Alan Braverman  <alanb@ncsa.uiuc.edu>
  112. Scott Powers    <spowers@ncsa.uiuc.edu>
  113.  
  114. Software Development Group
  115. National Center for Supercomputing Applications
  116.